Temenos Lifecycle Management Suite - Recovery Product Guide
Interest Accrual

The interest calculation process determines the amount of interest accrued for each active recovery account and repayment plan with a non-zero balance. The system also provides the ability to recalculate interest on recovery accounts and repayment plans and when variable interest rates have changed.

Prerequisites

The following items must be configured in order for the system to correctly calculate interest:

If any of these items are not configured, the interest calculation process fails and errors are logged to the Event log.
The accounting rule must be active for the date that interest is calculated.

Interest Calculation Interfaces

The interest calculation process can be executed manually within the workspace by a user or automatically through a nightly batch executable.

Manual Execution

The Recalculate Interest button allows users with the appropriate permission to initiate real-time interest calculations on recovery accounts and repayment plans.

The Recalculate Interest button can be added to the the following panels and screens:

  • The Repayment Plan Interest Rates panel within Repayment Plan screen types
  • The Recovery Account Interest Rates panel within Account screen types

Additionally, this button is only enabled for users and/or security groups who have the Recalculate Accounting Rule Interest Recovery permission set to Change.

This button is only enabled when the Calculation Pending flag is set to true for one or more accounting rules.

Automatic Execution

The Calculate All Interest (Akcelerant.AccountServicing.Exe.ComputeRecoveryInterest) nightly batch executable automatically calculates daily interest for all eligible recovery accounts and repayment plans. A recovery account or repayment plan is considered eligible for interest calculation if the Interest Last Calculated field does not contain today's date (i.e. interest has not yet been calculated today). The Interest Last Calculated field is set on recovery accounts and repayment plans each time the Calculate All Interest executable runs and successfully calculates interest for the recovery account or repayment plan.

The Interest Last Calculated field is available in the field list for addition to screens, views, reports, and queues.

Interest Calculation Algorithms

The system calculates both Annual Interest Rates and Daily Interest Rates for recovery accounts and repayment plans.

Annual Interest Rate

To calculate annual interest, the system locates the active accounting rule (indicated by the Active flag on the Recovery Account and Repayment Plan Interest Rates panels) for the recovery account or repayment plan, and then reviews the flags on the accounting rule that indicate which top-level GL forward accounts (Principal, Reimbursable Expense, Non-reimbursable Expense, etc.) are included in interest accrual calculations.

If the Is Variable Rate flag is set to true for the active accounting rule, the system uses a variable interest rate. The effective interest rate for the Interest Rate Type Id defined for the accounting rule is used to calculate interest. In this scenario, the annual interest rate equals the host interest rate plus the accounting rule interest rate modifier.

If the Is Variable Rate flag is set to false for the active accounting rule, the system uses a fixed interest rate. In this scenario, the annual interest rate equals the fixed interest rate defined in the accounting rule.

Once defined, the dates the annual interest rate is valid from and to are populated within the Interest Rates screen.

The system stores dates and times as the local date and time and do not include a time-zone indicator.

Daily Interest Rate

Once the annual interest rate is determined, one of the following methods are used to define the daily interest rate:

The daily interest rate calculation method is selected using the Default Calculation Method parameter located within the Recovery page in System Management (System Management > Modules > Recovery).
Method Description
Actual/Actual

Calculates the Daily Interest Rate using the following equation:

Current Principal * ((Interest Rate/100)/Number of days in the calendar year)

This calculation method is the most accurate.
Actual/360

Calculates the Daily Interest Rate using the following equation:

Current Principal * ((Interest Rate/100)/360)

      

Actual/365

Calculates the Daily Interest Rate using the following equation:

Current Principal * ((Interest Rate/100)/365)  

 

After daily interest is calculated, the rate is sent to the Transaction Processing Manager for processing and creation of Recovery Ledger entries based on Transaction Codes.

For more information on transaction processing, please see the Transaction Processing section of the Recovery Transactions topic in User Guide.

Interest Calculation Results

The following are characteristics of interest calculated within the Recovery module:

While money values are displayed as two decimal places, four decimal places are stored in the database. Money values greater than four decimal places are rounded to four decimal places using the industry standard "To Even" rounding algorithm, which is the default algorithm used by the Microsoft .NET Math.Round method.

Recalculating an Interest Rate

Temenos Infinity's interest rate change process recalculates interest on recovery accounts, repayment plans, and variable interest rates to ensure the correct amount of interest exists on recovery accounts and repayment plans. The interest rate change process occurs when a user changes an accounting rule on the Recovery Account or Repayment Plan Interest Rates panels and when an administrator modifies an interest rate in Interest Administration

Process to Recalculate Interest on Recovery Accounts and Repayment Plans

After a user makes a manual change to an interest rate on a recovery account or repayment plan or if they notice the Calculation Pending flag is set to true, clicking  on the Recovery Account or Repayment Plan Interest Rates panels launches the ad-hoc interest rate change process.

 must be manually added to the Recovery Account Interest Rates panel and the Repayment Plan Interest Rates panel.
If  is not clicked, the interest rate change process occurs automatically during the nightly Compute Recovery Interest processing.

The interest rate change process for recovery accounts and repayment plans is illustrated and described as follows:

 

  • The process to recalculate interest on recovery accounts and repayment plans begins by determining the date of the interest rate change based on the Calculation Pending flag.
The Calculation Pending flag is automatically set when a user manually makes a change to an interest rate on the Recovery Account or Repayment Plan Interest Rates panel.
  • The recovery account or repayment plan is locked to prevent it from being edited.
  • All transactions that have occurred since the date of the interest rate change are stored in the database.
  • All transactions that have occurred since the date of the interest rate change are reversed.
  • All transactions, including interest transactions, that have occurred since the date of the interest rate change are reprocessed.
The current date is used as the posting date for all reversal and reprocessed transactions. The transaction codes and GL accounts that were applied in the initial transactions are used for the reversal and reprocessed transactions.
  • The recovery account or repayment plan is unlocked to allow normal transaction processing to resume.
  • The Calculation Pending flag is set to false for the recovery account or repayment plan.
When interest calculation or accrual initiates, the transaction processing engine places a lock on the transaction currently in process. This lock ensures that only one recovery account or repayment plan transaction is processed at a time, mitigating the possibility of corrupt transaction data. If a transaction is currently in process and a user attempts to process another transaction, a "transaction in process" message is displayed indicating that the second transaction cannot be processed until the current transaction has completed processing.

 

Process to Recalculate Variable Interest Rates

After an administrator makes a change to an interest rate on the Interest Administration page, the nightly Compute Recovery Interest processing launches the interest rate change process.

The interest rate change process for variable interest rates is illustrated and described as follows:

 

The Calculation Pending flag is automatically set when a change is made to an interest rate in Interest Administration.
The current date is used as the posting date for all reversal and reprocessed transactions. The transaction codes and GL accounts that were applied in the initial transactions are used for the reversal and reprocessed transactions.
Reprocessing transactions may cause any payments applied to appear different in the GL account due to more or less interest being accrued.

 

 


©2023 Temenos Headquarters SA - all rights reserved.

Send Feedback